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The Persint program is designed for the three-dimensional representation of objects and for the interfacing and 
access to a variety of independent applications, in a fully interactive way. Facilities are provided for the spatial 
navigation and the definition of the visualization properties, in order to interactively set the viewing and viewed 
points, and to obtain the desired perspective. In parallel, applications may be launched through the use of 
dedicated interfaces, such as the interactive reconstruction and display of physics events. Recent developments 
have focalized on the interfacing to the XML ATLAS General Detector Description AGDD, making it a widely 
used tool for XML developers. The graphics capabilities of this program were exploited in the context of the 
ATLAS 2002 Muon Testbeam where it was used as an online event display, integrated in the online software 
framework and participating in the commissioning and debug of the detector system. 



1. INTRODUCTION 

Graphics programs in High Energy Physics experi- 
ments are necessary to visualize the detectors geome- 
try and display physics events. They help in the com- 
missionning phase of the experiment in debugging and 
understanding the systems. They must provide an 
interactive access to the event data and their recon- 
struction through online and offline algorithms. As 
such they play an important role in the search and 
discovery of new physics. 

Persint (Perspectively interacting) is an interactive 
visualization program [lj which is developed primely 
for the ATLAS collaboration 0. The display of ob- 
jects and the interactivity between the user and ob- 
jects or applications is realized through the use of the 
HIGZ package ;3]. Facilities dedicated to the spatial 
navigation and the definition of the visualization prop- 
erties are provided, in order to interactively set the 
viewing and viewed points, so as obtain the desired 
perspective. In parallel, applications may be launched 
through the use of dedicated interfaces, such as the in- 
teractive reconstruction and display of physics events. 



2. DESCRIPTION OF THE PROGRAM 



Monte Carlo events and in TestBeam applications, 
both online and offline. Persint is used for the vi- 
sualization of detector geometries : as such it is inter- 
faced to AMDB (the ATLAS Muon Database) and the 
AGDD-XML ATLAS Generic detector description. 

Other applications include the visualization of the 
magnetic field, the Level-1 Muon Trigger Logic, the in- 
teractive generation of tracks, and the display of XML 
event hits. 



2.2. Features 

The program offers the following features : 

• 3-dimensional representation of objects in full 
volumes or wire frames 

• computation of hidden faces 

• highlight of volumes edges 

• lighting intensity effects on volume facets 

• detection of clashing volumes and highlight of 
intersections 



2.1. Scope of the program 

Persint was originally developed as a tool for debug- 
ging and optimizing the ATLAS Muon pattern and 
track reconstruction algorithm Muonbox ,4j. It was 
early realized that traditional event displays based on 
simple projections were not fit to the task of visualiz- 
ing events in the toroidal, inhomogencous field of the 
muon spectrometer. Only a three-dimensional inter- 
active tool with navigation capabilities is well suited 
for such a task. 

The program is now routinely used for Event Dis- 
play of hits and reconstruction objects of complex 



• boolean volume operations (addition, subtrac- 
tion, intersection) 

• spatial navigation with real-time displacements 

• focal length adjustable at will (from isometry to 
wide-angle) 

• interfaces and access to applications 

• save to postscript 

• documentation 
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2.3. Design 

The core of the program is written in Fortran90. 
Dynamic data objects are extensively exploited in or- 
der to minimize the memory usage which can become 
important when a large numbers of volume are dis- 
played, a situation typical to modern HEP experi- 
ments, both with respect to the detector description 
and the event data themselves. 

Persint uses the following features of F90 : 

• usage of Modules, with procedure interfaces 

• Polymorphism 

• Recursive functions 

• Dynamic arrays 

• Allocate, for local memory management 

• Pointers 

• String operations 

• Array manipulations 

• Free source forms 

The graphics interface is HIGZ and in general 
the program makes extensive use of the CERNLIB [5j . 
It is built on 26000 lines on code and is part of 
the Saclay Muon software suite. As such it is inter- 
faced directly to the geometrical database Amdbsim- 
rec (13000 lines), the magnetic field database Bfield- 
dtb (3500 lines) and the track reconstruction algo- 
rithm Muonbox (58000 lines) 0. 

The code is highly modular, organized in patches. 
The XML section is such an example of a patch. It 
contains everything needed to parse, store transiently 
and generates volumes from standardized XML files. 

The computation of volumes with hidden faces is 
based on the analytical computation of facets' edges 
in space. This computation also provides the detec- 
tion of clashes and the highlights of the volumes in- 
tersections, and supports boolean volume operations. 

The program is designed to operate in standalone 
mode, keeping the possibility of integration in frame- 
works. It was for example successfully used in the 
context of the online software framework of the AT- 
LAS testbeams. 

2.4. Releases and documentation 

The program is released officially at CERN on AFS 
in a public directory 1 since version 2.00 for three plat- 
forms : Linux, Sun-Solaris Unix and Compaq/ Alpha 



Unix. This repository contains the source and exe- 
cutable files together with documentation and useful 
input databases, and for developers, the tools neces- 
sary to build, compile and load the code. The latest 
released version is 3.00. 

The documentation can be found in the Persint 
Manual located in the public repository or on the dedi- 
cated Persint Web Page 2 . This page provides updates 
on the releases. 

3. PRESENTATION OF THE PROGRAM 
3.1. General layout 

The program is designed around the command win- 
dow and the HIGZ display window. A typical view 
obtained with the Display Window is shown in Fig- 
ure n The command window is used essentially to 
load files and type commands interpreted by the code 
and documented in the Persint Manual. The display 
window however is organized in such a way to provide 
maximum interactivity to avoid typing commands as 
much as possible. 




Figure 1: Layout of the Persint Display Window, 
featuring the Navigator interface and an example of 3D 
volumes. 

The display window is dedicated to the colour dis- 
play of both the objects computed by the program for 
visualization and the graphical interfaces. The pri- 
mary interface is the Navigator. 



1 /afs/cern.ch/atlas/offline/external/Persint/ 2 http://cern.ch/Atlas/GROUPS/MUON/persint.html 
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Figure 2: Layout of the Navigator. 



The Navigator supports the navigation facilities 
necessary to survey the entire detector space and gives 
access to the various graphics applications provided by 
Persint. Its layout is shown in Figure [21 It consists in 
an ensemble of push buttons and gauges which can be 
clicked, so as to modify the visualization properties or 
access lower level interfaces. 

3.2. Navigation 

The spatial navigation, as well as the modification 
of the visualization properties, are realized through 
the use of gauges which define the amplitudes of the 
movements of the Viewing and Viewed Points and of 
the change in focal length of the observer eye, such 
as to obtain the desired perspective. Each action is 
validated with the "GO" Push Button. 

Alternatively, the navigation can be performed 
through real time displacements of the observer point. 
Continuous displacements are obtained by dragging 
the cursor over the display itself, thus bypassing the 
use of the Navigator. 

3.3. Visualization properties 

Persint offers the possibility to modify interactively 
the visualization focal length. In the Navigator, a sec- 
tioned gauge may be used to select the Normal View, 
equivalent to a focal length of 35 mm, the Isomet- 
ric View, equivalent to an infinite focal length, or to 
increase or decrease the focal length at will. 



Moreover, X, Y, Z, or <f> projections of the volumes 
on display may be obtained by clicking dedicated push 
buttons (see Figure 0). In the case of X, Y, and Z 
projections, the observing point position (e.g. X> 
or X< 0) can be modified by clicking the "Displace 
Viewing Point" 2D gauge on the corresponding half. 
In the case of </> projection, this same gauge can be 
used to define the value of <j). Examples of visualiza- 
tion of the same volumes with different perspectives 
are presented in Figure [5] 



4. EVENT DISPLAY 

The interactive reconstruction and event display 
(EVD) application of Persint is dedicated to the read- 
ing of event hit files, the visualization of these hits, 
and the reconstruction of the event through coupling 
to the Muonbox program 

The three-dimensional view of complex events is 
used to understand complex events and debug the 
reconstruction algorithms. Figure 0] shows a display 
of a Monte Carlo event in the ATLAS Muon spec- 
trometer in the context of a high background envi- 
ronment. Such events are generated with the Geant3- 
based DICE simulation All hits and activated 
muon chambers are displayed. The reconstructed 
track is displayed in blue. Visual inspection confirms 
the efficiency of the reconstruction algorithm in terms 
of pattern recognition and fitting. 

The projective views allows to further examine the 
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Figure 3: Example of perspectives. The ATLAS Muon Spectrometer Barrel Toroid is displayed under normal viewing 
condition, isometric view, wide angle view and projections. Note the corresponding settings in the Navigator interface. 
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Figure 4: Event Display. These views show the display of the same Monte Carlo event, a single muon track with high 
luminosity pile-up, generated with a safety factor 5 on cavern component. The blue line corresponds to a candidate 
track reconstructed by Muonbox. The top view is a 3-dimensional representation, the bottom view is an isometric 
projection. The Interactive Reconstruction and Event Display Interface is visible on top of the Navigator, as well as the 
event statistics window. 
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events, though it is necessary to restrict the investi- 
gation to a limited region of the apparatus. Zooming 
on detectors is performed to very carefully check the 
event properties and reconstruction consistency, as il- 
lustrated in Figure HI 




Figure 5: Event Display resulting from a zoom on a 
muon chamber. Visual investigation of such closeups 
allows to check the consistency of the event properties 
versus the reconstruction output. 

In Figure 0] one notes the Interactive Reconstruc- 
tion and Event Display Interface opened on top of 
the Navigator. This interface is equipped with an en- 
semble of push-buttons to set the visual properties of 
the displayed event and to activate the reconstruction. 
A separate embedded window is used to display the 
statistics of the event. The statistics consist essen- 
tially in the number of hits of the event, the number 
of hits taken into account in the candidate tracks, the 
reconstructed momentum, and if required from the 
datacards in case of physics channels analysis, the re- 
constructed invariant mass. 

The interfacing between Persint and Muonbox 
makes it possible to act interactively on the event 
characteristics to understand which role they play. 
For instance, a hit tube or a strip can be removed 
interactively from the event. Then, when re-running 
the reconstruction algorithms, this removed tube will 
not be taken into account. 

The Persint EVD was used in the design and opti- 
mization phase of the Muon Spectrometer, participat- 
ing in the performance studies of the apparatus and 
reconstruction software 0. It then contributed in re- 
fining the performances of this software on complex 
Monte Carlo physics channels @ . 

The program is used in the context of muon test- 
beams to display events on either online of offline 
mode |9( . Event displays are useful to testbeams in or- 



der to validate the commissioning of the entire chain of 
detectors and data acquisition. When data is recorded 
in a routine mode, the EVD participate in the online 
monitoring and the quality control of the dataflow. 
An example of testbeam event is shown in Figure [B] 
It consists in a staight muon track reconstructed in the 
Barrel stand of the H8 2002 Muon System tests jT^j- 
Chambers misalignment is corrected using conditions 
alignment data. 
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Figure 6: H8 2002 Muon Testbeam Event Display. 



5. GEOMETRY VISUALIZATION 

Powerful graphics tool are necessary to develop and 
debug the geometrical descriptions of the complex 
HEP detectors. Not only 3D viewers and projective 
capabilities must be used, but also the possibility to 
automatically detect geometrical conflicts. 

An essential feature of geometry visualization pro- 
grams is to be able to delineate precisely the volume 
edges. This is of primary importance in order to 
clearly identify the volumes boundaries in space and 
their possible interferences. Such visual property of- 
fers a much better understanding and comprehension 
of the detector geometry to the end user. 

Modern geometrical description in HEP makes ex- 
tensive use of boolean volume operations, which 
greatly simplifies the task of describing complicated 
geometries. Visualization tools must therefore sup- 
port such technology. 
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Figure 7: Visualization of AGDD-XML volumes and associated XML tree structure. In this example, one of the Endcap 
Toroid of the Atlas Muon spectrometer is displayed on the right. The corresponding XML tree is shown on the left. 




Figure 8: Visualization of AMDB volumes. Intersection 
of volumes are detected and highlighted in red. 



The Persint program is interfaced to the two detec- 
tor description used for the ATLAS Muon Spectrom- 
eter : AGDD-XML and AMDB. 



5.1. Interface to AGDD-XML 



The Atlas Generic Detector Description is based on 
standardized XML files. Such a description is used to 
describe the Muon Spectrometer geometry This 
description is implemented in the reconstruction algo- 
rithm. 

The Persint program benefits from an XML parser 
to interpret the corresponding geometrical descrip- 
tion. The working of the interface to AGDD is based 
on the representation of a fully clickable tree-like 
structure allowing selection of the desired volumes for 
display. An operating example is given in Figure Q 
showing both the XML structure and the correspond- 
ing volumes, in this case one of the ATLAS Endcap 
toroid. 

The interface offers the representation of the volume 
tree in its full depth. The user can deploy or hide sub- 
structures by clicking Volume Tree Pointers appearing 
as arrows. 

Conveniently, geometries can be visualized in par- 
allel as they are being developped. After a possible 
modification, clicking on a a dedicated push button of 
the Navigator (see Figure EJ) results in the reloading 
of the database. 
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5.2. Interface to AMDB 

The ATLAS Muon Database is an object-oriented 
database for simulation and reconstruction 3 . It is 
extensively used in the detectors and physics per- 
formance studies conducted since the origin of AT- 
LAS 0, @- I n particular, it is used synchroneously 
by the DICE Geant3 simulation of the experiment |g] 
and the muon reconstruction program Muonbox Q . 

This database is heavily used to study the ongo- 
ing changes to the spectrometer layout |l2j. Such 
changes are caused by the need to take into account 
integration and access constraints. Also, the possi- 
ble staging of ATLAS will lead to multiple geometri- 
cal configuration, to be optimized by simulation. In 
this context of evolving geometries, Persint provides a 
tool to carefully scrutinize and validate the geomet- 
rical databases. One of the important capabilities 
of Persint is to detect and highlight intersecting or 
clashing volumes. An illustration is given in Figure [S| 
where a conflict between a muon chamber and the feet 
of the detector is observed. 



6. BOOLEAN OPERATIONS 

Persint offers the rare feature of being able to com- 
pute fully and display volumes resulting from Boolean 
operations. 

Being given two initial Supervolumes (a Supervol- 
ume is an ensemble of volumes) , the program is able 
to perform the three basic operations (addition, sub- 
traction, intersection) to generate a new Supervolume. 
This facility is independent of the complexity of the 
initial objects. An example is shown in Figure [5J 
which illustrates how the program can generate the 
voussoirs of the Barrel Toroid. 

Using this feature of Persint, it is possible to gener- 
ate complex-shaped volumes from very basic objects. 
The program provides, through the Command Mode, 
a set of instructions allowing to generate basic volumes 
and to perform Boolean operations. 



7. OTHER APPLICATIONS 

The Persint program is interfaced to a variety of 
application. They are all accessed through the Navi- 
gator (see Figure El- 

The Level 1 Interface is the application allowing the 
interactive access to the Level- 1 Muon Trigger con- 
figuration datafiles and the visual representation of 
the variety of objects involved in the trigger decision 
chain. This interface is extensively described in |13| . 
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Figure 9: Example of Boolean Volume Operations. 

The Magnetic Field Interface provides a fully in- 
teractive 3D visualization of the Magnetic Field and 
the magnet elements. This application is coupled to 
the Bfielddtb set of subroutines that read the field 
database and compute the field at any given point 4 . 
The field is visualized by means of arrows located at 
a series of lattice points. An example is shown in 
Figure ITUI The direction and length of the arrow cor- 
respond to the direction and magnitude of the B-field. 
The lattice, either 2D or 3D, is customized by the user 
in terms of mesh and spatial limits, allowing to build 
the vector field either in very localized regions or over 
large distances. 

The Muon Tracks Interface is used to generate and 
compute tracks of muons throughout the entire detec- 
tor system. It is coupled to Muonbox, to the detector 
description and the magnetic field database, in order 
to compute the track's trajectory, taking into account 
the deflections in the field, the multiple scattering, 
and the energy loss in matter. 



8. PERFORMANCES 

Performances are difficult to estimate, as the visu- 
alization programs have too face many possible situa- 
tions in terms of user demand, and number of volumes 
to display. 



3 see |http : / /cern . chjm uondoc /software / D at abase/ 4 see http://cern.ch/Atlas/GROUPS/MUON/magfield/ 
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Figure 10: Visualization ol the magnetic field and 
magnet elements. 

A test is performed here as follows : the display 
and navigation capability is estimated on a 2.8 GHz 
Pentium 4. It requires 0.65 s to compute and display 
the 2300 voulumes with 15000 facets of the Muon pre- 
cision chambers system. The real-time displacements 
are fluid (> 10 views per second) for a number of vol- 
umes < 400. 

An event scan on testbeam data provides another 
performance measurement. In the exercise consisting 
in the display of events in loop with 6 chambers and 
typically 20 hits, it needs 0.02 s/event for bare EVD. 
This an order of magnitude less than the time needed 
to reconstruct the event : 0.20 s/event. 

9. CONCLUSIONS AND PROSPECTS 

The present design of the program has strong ad- 
vantages. The user can download a single executable 
binary files. No special dynamic library loading, no 
fancy APIs need to be installed. The program is effi- 
cient even if operated remotely, e.g. on remote clusters 
from a X-terminal. 

On the other side, the program has shortcomings. 
It uses a limited graphics interface (256 colors in the 
current version of HIGZ, possibly extended to 1024). 
It does not profit from the high performance capabil- 
ities of graphics cards when operated locally on PCs 
(Z-buffer). 

In the developments under consideration, a migra- 
tion to OpenGL is envisaged. However some of the 
features of the present design would be lost. For ex- 



ample, such technology based on Z-buffer doesn't al- 
low to delineate the volume edges. This property is 
crucial for HEP detectors. 

It is considered to integrate parts of Persint in the 
ROOT data analysis framework. The graphics ca- 
pabilities of ROOT would be enhanced by using the 
calculus of hidden faces and intersecting volumes. In 
parallel, the integration of Persint in the ATHENA 
Atlas software framework for reconstruction and anal- 
ysis can be studied. 

The utilization of Persint will continue as an event 
and geometry display for the ATLAS experiment. It 
will be used as online EVD in the H8-2003 Muon Test- 
beam, and in the H8-2004 ATLAS Combined Test- 
beam. It will have an important role to play in the 
commissioning of ATLAS, participating in the debug 
of the detector (cosmics run, calibration runs,...). Fi- 
nally it is a candidate for the ATLAS Online EVD for 
monitoring of data-taking. 
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